home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / amos / apme13.lha / AmosProMultiEnv / ReadMe.Doc < prev    next >
Text File  |  1992-02-26  |  8KB  |  275 lines
  1.  
  2.  
  3.              AMOSPro 1.12/2.00  Multi-Envoironment Patch V1.3
  4.              ------------------------------------------------
  5.  
  6.            Written By Paul Hickman (ph@doc.ic.ac.uk) - June 1994
  7.            ----------------------------------------------------
  8.  
  9.       Adapted from AMOS Multi-Envoironment Patch V1.1  for AMOS 1.36
  10.       --------------------------------------------------------------
  11.  
  12.  
  13.  
  14. IMPORTANT
  15. =========
  16.  
  17.     APME V1.2 contained a bug which made Amospro V2.00 crash. Before
  18.     installing this fixed version, copy your original unpatched AmosPro
  19.     V2.00 file over the patched AmosPro file in you AMOSPro_System:
  20.     directory.
  21.  
  22.  
  23.  
  24. Disclaimer
  25. ----------
  26.  
  27.         The program PatchAMOSPro will modify your AMOSPro program.
  28.         I take no resposibility if it wreck's it - make sure you
  29.         have a backup.
  30.  
  31.         I also take no responsibilty explicitly, implicity, and all
  32.         that other legal crap if something else that you didn't want
  33.         to happen does, 'cos i'm still in an irresponsible mood!
  34.  
  35.  
  36.  
  37. Distribution
  38. ------------
  39.  
  40.         Whatever - modify / copy / hack to pieces. Please post me
  41.         back any improvements - these are among my first E programs,
  42.         so the sources can probably be improved.
  43.  
  44.  
  45. Files
  46. -----
  47.  
  48.         Install_AMOSProMultiEnv        The installer script
  49.  
  50.         AmosIcon                       An Icon To Load AMOSPro.
  51.         GetAMOSProEnv                  A Program to select an envoironment.
  52.         PatchAMOSPro                   A Program to modify AMOSPro file.
  53.         Readme.Doc                     This File.
  54.  
  55.         GetAMOSProEnv13.e              The Sources
  56.         PatchAMOSPro.e
  57.  
  58.  
  59.  
  60.  
  61. Requirements
  62. ------------
  63.  
  64.         AMOSPro V1.12 or V2.00 - NOT AMOSPro V1.0, or any other version.
  65.         2 bytes are overwritten in the AMOSPro program file - they may
  66.         be at a different location in different versions of AMOSPro.
  67.  
  68.         ReqTools Library - Any version will probably work - I only
  69.         use the file requester.
  70.  
  71.  
  72.  
  73.  
  74. Overview
  75. --------
  76.  
  77.         When you load AMOSPro, it searches for one of the files:
  78.  
  79.         S:AMOSPro_Interpreter_Config
  80.         AMOS_ProSystem:S/AMOSPro_Interpreter_Config
  81.  
  82.  
  83.         And loads the first one it finds. These files contain your
  84.         AmosPro interpreter configuration (Suprisingly enough) which
  85.         contains the loaded extensions, number of bobs, copperlist
  86.         buffer size etc. Running PatchAMOSPro modifies AMOSPro so it
  87.         searches the files:
  88.  
  89.         T:AMOSPro_Interpreter_Config
  90.         S:AMOSPro_Interpreter_Config
  91.  
  92.  
  93.         GetAMOSProEnv opens a reqtools filerequester in the directory
  94.         AMOSPro_System:APSystem/Interpreter_Configs (Which is created
  95.         by the installer scripts). Initially this contains the file
  96.         Default.config. Whatever file you select here is copied to
  97.         T:AMOSPro_Interpreter_Config before AMOSPro is run hence 
  98.         becoming the configuration you use for that session.
  99.  
  100.  
  101.  
  102.  
  103.  
  104. Installation
  105. ------------
  106.  
  107.  
  108.         Just double click the installer icon and select your AMOSPro
  109.         System directory / disk.
  110.  
  111.         AMOSPro will be patched, the configs directory created, your
  112.         current configuration copied into it as the default, the
  113.         GetAMOSProEnv program is copied into the AMOSPro_System directory,
  114.         along with an iconx script to load AMOSPro via the selector.
  115.  
  116.  
  117.         AMOSPro can still be run with it's default config in S: by
  118.         double clicking on it's original icon.
  119.  
  120.  
  121.  
  122.  
  123. Usage
  124. -----
  125.  
  126.         Double click on the "Amos Env-Loader" icon. Select An 
  127.         Envoironment.
  128.  
  129.  
  130.  
  131.  
  132. Multi-Selection
  133. ---------------
  134.  
  135.         To load AMOSPro with an AMOS program in the editor & run the
  136.         program, select the program's icon, then shift double-click
  137.         the "Amos Env-Loader" icon.
  138.  
  139.  
  140.  
  141.  
  142. Toolmanager
  143. -----------
  144.  
  145.         AMOSPro Multi-Env works great from a toolmanager dock window, or
  146.         toolmanager App Icon. Simply create an exec object to the Amos
  147.         script, of type CLI, which has the "Arguments" box checkmarked.
  148.         Then create an image object, and a dock / icon object to launch
  149.         it.
  150.  
  151.         To run AmosPro from toolmanger, click on the dock icon / app icon.
  152.         To load a file into AmosPro from toolmanager, drop the file on the
  153.         dock icon / app icon.
  154.  
  155.  
  156.  
  157.  
  158. Modifing Configurations
  159. -----------------------
  160.  
  161.         To modify a configuration, select "Set Interpreter" from the config
  162.         menu, then select "Load other configuration". Goto the directory
  163.         "AMOSPro_System/APSystem/Interpreter_Configs" and choose a
  164.         configuration to modify. Change it, then save it to a new file in
  165.         the same directory. End the filename in ".config" so it matches
  166.         the filer pattern "#?.config" in the GetAMOSProEnv filerequester.
  167.  
  168.         To not save/load the default configuration as this is not used
  169.         when loading AMOSPro via the Env-Loader. Instead, the 
  170.         Default.Config file is used for the default configuration.
  171.         
  172.  
  173.  
  174. Notes / Hints
  175. -------------
  176.  
  177.     
  178.         The AMOS 1.36 compiler uses the envoironment specified by it's
  179.         own configuration files - Not the envoironment you select
  180.         with this filerequester. I don't know what the AMOS Pro compiler
  181.         does, as I don't have it.
  182.  
  183.  
  184.         Get toolmanger, and use it - it's easily the best way to
  185.         load AMOSPro. If you do this set the save with icons option
  186.         in the configuration editor so your programs have
  187.         icons to drop on the toolmanager dock/app icon.
  188.  
  189.  
  190.  
  191. Credits
  192. -------
  193.  
  194.         GetAMOSProEnv, and PatchAMOSPro were both written in E. Thanks
  195.         go to Wouter van Oortmerssen for a rather nice language.
  196.  
  197.         Reqtools.library is written by Nico Francois.
  198.  
  199.         Toolmanager was written by Stefan Becker.
  200.  
  201.  
  202.         The E language, Reqtools & Toolmanager are all available
  203.         on aminet. Thanks also to whoever it was that posted to the
  204.         AMOS mailing list about removing/installing extenions for
  205.         the inspiration!
  206.  
  207.  
  208.  
  209.  
  210. Changes: AMOSMultiEnv V1.0 ---> V1.1
  211. ------------------------------------
  212.  
  213.     Both E programs now use exception handling for error
  214.     recovery, and print errors to requesters, not the command line.
  215.  
  216.     PatchAMOS can now accept the AMOS file to patch as a
  217.     command line argument.
  218.  
  219.     Both programs now accept the argument in double quotes.
  220.  
  221.     The installer script now creates a customised launching
  222.     script for your system - there is no "Amos" file in the
  223.     distribution anymore.
  224.  
  225.     The cancel button in the filerequester now cancels the
  226.     Loading of AMOS.
  227.  
  228.     Shift-Selected / Toolmanager / CLI arguments to the AMOS
  229.     script are passed on to AMOS1.36 so you can autoload & run
  230.     programs.
  231.  
  232.  
  233.  
  234.  
  235. Changes: AMOSMultiEnv V1.1 ---> AMOSProMultiEnv V1.1
  236. ----------------------------------------------------
  237.  
  238.     All file directory names in Installer Script, Readme file
  239.     and E programs changed to AMOSPro versions.
  240.  
  241.     PatchAMOSPro now changes the relevant bytes for AMOSPro V1.12
  242.  
  243.     The installer script now creates a directory for configs, and
  244.     copies your current default into it.
  245.  
  246.  
  247.  
  248.  
  249. Changes: AMOSProMultiEnv V1.1 ---> AMOSProMultiEnv V1.2
  250. -------------------------------------------------------
  251.  
  252.     Title of error requesters changed.
  253.  
  254.     Now works for Amospro V2.00 as well as V1.12.
  255.  
  256.  
  257.  
  258.  
  259. Changes: AMOSProMultiEnv V1.2 ---> AMOSProMultiEnv V1.3
  260. -------------------------------------------------------
  261.  
  262.     It turns out I was lying last time - it didn't work for AMOS V2.00.
  263.     This is now fixed.
  264.  
  265.     Memory allocation bugs have been fixed in both E programs. It used to
  266.     "forget" the filename between you selecting it, and it opening it
  267.     before - now it doesn't
  268.  
  269.     AMOSPro V2.00 searched for the files in S: first, then T:, so you
  270.     had to delete the copy in S: for it to work. This is now reversed -
  271.     T: is searched first, so you can still keep a copy in S:
  272.  
  273.  
  274.  
  275.